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@ Self-configuration of nodes in a distributed message-based operating system. 

@ In a distributed system comprising a plurality of nodes 
(170-174. FIG. 7), each node is provided with the same set of 
generic configuration rules which configures the resources for 
the node according to the application requirements and the 
hardware configuration of the node. The resource server 
modules (231-234. FIG. 8) are configuracie at run-time by 
node-based configuration management orocesses (230) in 
accordance with information contained in resource definition 
messages. A resource definition message is derived from a 
resource template message in accordance with the information 
contained in the node definition message. Accordingly, adding 
or modifying resources at a given node can be accomplished at 
start-up or at run time without affecting the remainder of the 
system. 
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RELATED INVENTIONS . ^ ^ . .u 

The present inventfon is related to the following inventions, all filed on May 6, 1986 and ail assigned to the 

assignee of the present invention: 

1. Title: Nested Contexts rn a Virtual Single Machine 
Inventors: Andrew Kun, Frank Kolnick, Bruce Mansfield 
Serial No.: 730,903 

2. Title : Computer System with Data Residence Transparency and Data Access Transparency 
Inventors: Andrew Kun, Frank Kolnick, Bruce Mansfieid 

Serial No.: 730.929 

STitle: Network Interface Module with Minimized Data Paths 
Inventors: Bernhard Welsshaar, Michael Barnea 
Serial No.: 730.621 

4. Title : Method of Inter-Process .Communication in a Distributed Data Processing System 
Inventors : Bernhard Weisshaar, Andrew Kun, Frank Kolnick, Bruce Mansfield 

Serial No.: 730,892 

5. Title : Logical Ring in a Virtual Single Machine 
Inventors: Andrew Kun, Frank Kolnick, Bruce Mansfield 
Serial No.: 730,923 

6. Title : Virtual Single Machine With Message-Like Hardware Interrupts and Processor Exceptions 
Inventors: Andrew Kun, Frank Kolnick, Bruce Mansfield 

Serial No.: 730,922 

The present invention is also related to the following inventions, ail filed on even date herewith, and all 

assigned to the assignee of the present invention: 

7. Title: Computer Human interface Comprising User-Adjustabie Window for Displaying or Printing 
Information 

Inventor: Frank Kolnick 
Serial No.: 000,625 

8. Title: Computer Human Interface With Multi-Application Display 
Inventor: Frank Kolnick 

Serial No.: 000,620 

9. Title : Object-Oriented Software Architecture Supporting Input/Output Device Independence 
Inventor: Frank Kolnick 

Serial No.: 000,619 

1 0. Title : Process Traps in a Distributed Message-Based Operating System 
Inventors: GaborSimor 
Serial No.: 000,624 

12. Title: Computer Human Interface with Multiple Independent Active Pictures and Windows 
Inventors: Frank Kolnick 
Serial No.: 000.626 



TECHNICAL FIELD 

45 This invention relates generally to digital data processing, and, in particular, to a distributed operating 
system which configures the resources required for each node in real time. 

BACKGROUND OF THE INVENTION 
The present invention is implemented in a distributed data processing system - that is, two or more data 
50 processing systems which are capable of functioning independently but which are so coupled as to send and 

receive messages to and from one another. 

Local Area Network (LAN) is an example of a distributed data processing system. A typical LAN comprises a 

number of autonomous data processing "nodes", each comprising at least a processor and memory. Each 

node is capable of conducting data processing operations independently. In addition, each node is coupled 
55 (by appropriate means such as a twisted wire pair, coaxial cable, fiber optic cable, etc.) to a network of other 

nodes which may be, for example, a loop star, tree etc., depending upon the design considerations. 
As mentioned above, the present invention finds utility in such a distributed data processing system, since 

there is a need in such a system for processes which are executing or which are to be executed in the 

individual nodes to share data and to communicate data among themselves. 
60 A "process", as used within the present invention, is defined as a seif-contained package of data and 

executable procedures which operate on that data, comparable to a "task" in other known systems. Within the 

present invention a process can be thought of as comparable to a subroutine in terms of size, complexity, and 

the way it is used. The difference between processes and subroutines is that processes can be created and 
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destroyed dynamically and can execute concurrently with their creator and otlier "subroutines:. 

Within a process, as used in the present invention, the data is totally private and cannot be accessed from 
the outside, i.e., by other processes. Processes can therefore be used to Implement "objects", "modules", or 
other higher-level data abstractions. Each process executes sequentially. Concurrency is achieved through 
multiple processes, possibly executing on multiple processors. 5 

Every prcfcess in the distributed data processing system of the present invention has a unique identrfier 
(PiD) by which it can be referenced. The PID is assigned by the system when the process is created, and it is 
used by the system to physically locate the process. 

Ever/ process also has a non-unique, symbolic "name", which is a variaWe-length string of characters. In 
general, the name of a process is known system-wide. To restrict the scope of names, the present invention w 
utilizes the concept of a "context". 

A "context" is simply a collection of related processes whose names are now known outside of the context. 
Contexts partition the name space into snnaller, more manageable subsystems. They also "hide" names, 
ensuring that processes contained in them do riot unrnten tionaTly conflict watti those m other contexts. 

A process in one context cannot expHcitty communrcate with, and. does not know about, processes inside 15 
other contexts. All interaction across context boundaries must be through a "context process", thus providing 
a degree of security. The context process often acts as a switchboard for incoming messages, rerouting them 
to the appropriate sub-processes in its context. 

A context process behaves like any other process and additionally has the property that any processes 
which it creates are known only to itself and to each other. Creation of the process constitutes definition of a 20 
new context with the same name as the process. 

Any process can create context processes. Each new context thus defined is completely contained inside 
the context in which it was created and therefore is shielded from outside reference. This 'nesting allows the 
name space to be structured hierarchically to any desired depth. 

Conceptually, the highest level In the hierarchy is the system Itself, which encompasses all contexts. 25 
Nesting is used in top-down design to break a system into components or "layers", where each layer is more 
detailed than the preceding one. This is analogous to breaking a task down into subroutines, and in fact many 
applications which are single tasks on known systems may translate to multiple processes in nested contexts. 

A "message" is a buffer containing data which tells a process what to do and/or supplies it with information 
it needs to carry out its operation. Each message buffer can have a different length (up to 64 kilobytes). By 30 
convention, the first field in the message buffer defines the type of message (e.g., "read "."print", "status", 
"event", etc.). 

f^essages are queued from one process to another by name or PID. Queuing avoids potential 
synchronization problems and is used instead of semaphores, monitors, etc. The sender of a message Is free 
to continue after the message is sent. When the receiver attempts to get a message, it will be suspended until 35 
one arrives if none are already waiting in its queue. Optionally, the sender can specify that it wants to wait for a 
reply and is suspended until the specific message arrives, fvtessages from any other source are not dequeued 
until after that happens. 

Within the present invention, messages are the only way for two processes to exchange data. There is no 
concept of a "global variable". Shared memory areas are not allowed, other than through processes which 40 
essentially "manage" each area by means of messages. Messages are also the only form of dynamic memory 
that the system handles. A request to allocate memory therefore returns a block of memory which can be used 
locally by the process but can also be transmitted to another process. 

Messages provide the mechanism by which hardware transparency is achieved. A process located 
anywhere in the system may send a message to any other process anywhere else in the system (even on 46 
another processor) if it knows the process name. This means that processes can be dynamically distributed 
across the system at any time to gain optimal throughput without charging the processes which reference 
them. Resolution of destinations is done by searching the process name space. 

The context nesting level determines the "scope of reference" when sending messages between processes 
by name. From a given process, a message may be sent to ail processes at its own level (i.e., in the same 50 
context) and (optionally) to any arbitrary higher level. The contexts are searched from the current context 
upward until a match is found. All processes with the given name at that level are then sent a copy of the 
message. A process may also send a message to itself or to its parent (the context process) without knowing 
either name explicitly, permitting multiple instances of a process to exist in different contexts, with different 
names. 55 

Sending messages by PID obviates the need for a name search and ignores context boundaries. This is the 
most efficient method of com.municating. 

It is known in the data processing arts to utilize an expert system to configure the optimum data processing 
hardware and software components for shipment to a customer based upon the customer's order. However, 
such configuration is performed off-line by an independent data processing system. so 

It is also known to change the number and specific configuration of nodes in a distributed system. However, 
this capability has previously been able to be performed only by taking the system down, making the 
necessary changes to the operating system, recompiling, and reHnking. It could not be performed in real-time. 

There is thus a significant need to be able to provide within a data processing operating system the ability io 
configure quickly and efficiently the various resources required by each noda. Examples of such resources 65 



0 274 406 



are, for example, terminal ports, windows, files, processes, and I/O devices. Basically in the data processing 
system of the present invention what is meant by a resource is a logic device which is available to an 
application. A resource need not necessarily be related to a physical device. 

5 BRIEF SUMMARY OF INVENTION 

Accordingly, it is an object of the present invention to provide a data processing system having an improved 
operating system. 

It is also an object of the present invention to provide an improved data processing system having an 
operating system which allows resources at any node to be quickly and efficiently configured. 

10 it is another object of the present invention to provide an improved data processing system having an 
operating system which allows resources at any node to be configured at the start-up time or at run-time. 

It is yet object of the present invention to prov/de an im,proved data processing system having an operating 
system wherein resources can be added or modified at a give>n node at start-up lime or at run-time without 
adversely affecting the remainder of the system. 

15 These and other objects are achieved in accordance with a preferred embodiment of the inveniion by 
providing in a distributed data processing system comprising a plurality of interconnected nodes, at least one 
of said nodes comprising a set of resource configuration rules for configuring resources on any node of the 
system, a method of configuring resources for a specific node of the system, the method comprising the steps 
of a) providing to the specific node a resource definition message and b) utilizing the resource definition 

20 message to configure a resource server module for each resource type needed by the specific node. 

BRIEF DESCRIPTION OF THE DRAWINGS 

The invention is pointed out with particularity in the appended claims. However, other features of the 
invention will become more apparent and the invention will be best understood by referring to the following 
25 detailed description in conjunction with the accompanying drawings in which: 

FIG. 1 shows a representational illustration of a single network, distributed message-based data 
processing system of the type incorporating the present invention, 

FIG. 2 shows a block diagram illustrating a multiple-network, distributed message-based data 
processing system of the type incorporating the present invention. 
30 FIG. 3 shows an architectural model of a data processing system of the type incorporating the present 

invention. 

FIG. 4 shows the relationship between software contexts and processes as they relate to the present 
invention. 

FIG. 5 show how messages may be sent between processes within nested contexts. 
35 FiG. 6 shows the standard format of a message in a distributed data processing system of the type 

incorporating the present invention. 

FIG. 7 shows how Resource Template Messages, Node Definition Messages, and Resource Server 
Modules are used in the present invention. 

FIG. 8 shows in flow diagram form how Resource Definition Messages are generated to a Resource 
40 Server Module. 

FIG. 9A shows a flowchart illustrating the Initial Resource Processing module of the present invention. 
FIG. 9B shows a flowchart illustrating the Instantiate Resource module of the present invention. 
FIG. 9C shows a flowchart illustrating a module to Derive Resource Definition Message from Resource 
Template. 

45 FIG. 90 shows a flowchart illustrating a module to Check Resource Attributes in this Node 

Environment, 



OVERVIEW OF COMPUTER SYSTEM 
With reference to FIG. 1, a distributed computer configuration is shown comprising multiple nodes 2-7 
50 (nodes) loosely coupled by a local area network (LAN) 1 . The number of nodes which may be connected to the 
network is arbitrary and depends upon the user application. Each node comprises at least a processor and 
memory, as will be discussed in greater detail with reference to FIG. 2 below. In addition, each node may also 
include other units, such as a printer 8, operator display module (ODM) 9, mass memory module 13, and other 
I/O device 10, 

55 With reference now to FIG. 2, a multiple-network distributed computer configuration is shown. A first local 
area network LAN 1 comprises several nodes 2,4, and 7. LAN 1 is coupled to a second local area network 
LAN 2 by means of an Intelligent Communications Module (ICM) 50. The Intelligent Communications Module 
provides a link between the LAN and other networks and/or remote processors (such as programmable 
controllers). 

60 LAN 2 may comprise several nodes (not shown) and may operate under the same LAN protocol as that of 
the present invention, or it may operate under any of several commercially available protocols, such as 
Ethernet: MAP, the Manufacturing Automation Protocol of General Motors Corp.; Systems Network 
Architecture (SNA) of International Business Machines, Inc.; SECS-11; etc. Each ICM 50 is programmable for 
carrying out one of the above-mentioned specific protocols. In addition, the basic processing module of the 

65 node itself can be used as .an intelligent peripheral controller (IPC) for specialized devices. 
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LAN 1 is additionally coupled to a third local area network LAN 3 via ICM 52. A process controller 55 fs also 
coupled to LAN 1 via \CM 54, 

A representative node N {7. FIG. 2) comprises a processor 24 vvhicii, in a preferred embodiment, is a 
processor from the Motorola 68000 family of processors. Each node further irK;ludes a read only memory 
(ROM) 28 and a random access memory (RAM) 26. In addition, each node includes a Network Interface 5 
Module (NIM) 21. which connects the node to the LAN. and a Bus interface 29. which couples the node to 
additional devices within a node. While a minimal node is capable of supporting two peripheral devices, such 
as an Operator Display Module (ODM) 41 and an I/O Module 44. additional devices (including addkional 
processors, such as processor 27) can be provided within a node. Other additional devices may comprfse, for 
example, a printer 42, and a massstorage module 43 which supports a hard disk and a back-up device (floppy w 
disk or streaming tape drive). 

The Operator Display Module 41 provides a keyboard and screen to enable an operator to input information 
and receive visual information. 

While a single node may comprise all of the above units, in the typical user application individual nodes will 
normally be dedicated to specialized functions. For example, one or more mass storage nodes may be set up is 
to function as data base servers. There may also be several operator consoles and at, least one node for 
generating hard-copy printed output. Either these same nodes, or separate dedicated nodes, may execute 
particular application programs. 

The system is particularly designed to provide an integrated solution for factory automation, data 
acquisition, and other real-time applications. As such, it includes a full complement of services, such as a 20 
graphical output, windows, menus, icons, dynamic displays, electronic mail, event recording, and file 
management. Software development features include compilers, a window-oriented editor, a debugger, and 
performance-monitoring tools. 

Lacaf Area Network 25 

The local area network, as depicted in either FIG,1 or FIG. 2, ties the entire system together and makes 
possible the distributed virtual machine model described below. The LAN provides high throughput, 
guaranteed response, reliability, and low entry cost. The LAN is also autonomous, in the sense that all system 
and applications software is unaware of its existence. For example, any Network Interface Module (e.g. NIM 21, 
FIG. 2) could be replaced without rewriting any software other than that which directly drives it. 30 

The LAN interconnection medium may be twisted-pair or coaxial cable. Two channels (logically, two distinct 
networks) may be provided for reliability and for increased throughput. 

The LAN architecture is a logical ring, in which an electronic "token" Is constantly passed from node to node 
at high speed. The current holder of the token may use it to send a "frame" of data or may pass it on to the next 
node in the ring. The NIM only needs to know the logical address and status of its immediately succeeding 35 
neighbor. The NIM*s responsibility is limited to detecting the failure of that neighbor or the Inclusion of a new 
neighbor. In general, adjustment to failed or newly added nodes is automatic. 

The network interfaces maps directly into the processor's memory. Data exchange occurs through a 
dual-ported buffer pool which contains a linked list of pending "frames". Logical messages, which vary in 
length are broken into fixed-size frames for transmission and are reassembled by the receiving NIM. Frames 40 
are sequence-numbered for this purpose. If a frame is not acknowledged within a short period of time, it is 
retransmitted a number of times before being treated as a failure. 

As described above with reference to FIG. 2. the LAN may be connected to other LAN's operating under the 
same LAN protocol via so-called "bridgeways", or it 'may be connected to other types of LAN's via "gateways". 

45 

Software Model 

The computer operating system of the present invention operates upon processes, messages, and 
contexts, as such terms are defined herein. Thus this operating system offers the programmer a hardware 
abstraction, rather than a data or control abstraction. 

Processes are referenced without regard to their physical location via a small set of message-passing 50 
primitives. As mentioned earlier, every process has both a unique system-generated identifier and a not 
necessarily unique name assigned by the programmer. The identifier provides quick direct access, while the 
name has a limited scope and provides symbolic, indirect access. 

With reference to FIG. 3, an architectural model of the present Invention is shown. The bottom, or hardware, 
layer 63 comprises a number of processors 71-76, as described above. The processors 71-76 may exist 56 
physically within one or more nodes. The top, or software, layer 60 illustrates a number of processes P1-P10 
which send messages m1-m6 to each other. The middle layer 61. labelled "virtual machine", isolates the 
hardware from the software, and it allows programs to be written as if they were going to be executed on a 
single processor. Conversely, programs can be distributed across multiple processors without having been 
explicitly designed for that purpose. so 

The Virtual Machine 

As discussed earlier, a "process" is a self-contained package of data and executable procedures which 
operate on that data. The data is totally private and cannot be accessed by other processes. There is no 
concept of shared memory within the present invention. Execution of a process Is striotiy sequential. Multiple 65 
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processes execute concurrently and must be scheduled by the operating system. The processes can be 
re-entrant, in which case only one copy of the code Is loaded even if multiple Instances are active. 

Every process has a unique "process identifier number" (PID) by which it can be referenced. The PID is 
assigned by the system when the process Is created and remains in effect until the process terminates. The 
5 PID assignment contains a randomizing factor which guarantees that the PID will not be re-used in the near 
future. The contents of the PID are Irrelevant to the programmer but are used by the virtual machine to 
physically locate the process. A PID may be thought of as a "pointer" to a process. 

Every process also has a "name" which is a variable-length string of characters assigned by the 
programmer. A name need not be unique, and this ambiguity may be used to add new services transparently 
10 and to aid in fault-tolerance. 

FIG. 4 illustrates that the system-wide name space is partitioned into distinct subsets by means of 
"contexts" identified by reference numerals 90-92. A context is simply a collection of related processes whose 
names are not known outside of the context. Context 90, for example, contarns processes A, a, a, b, c, d, and 
e. Context 91 contains processes B, a, b. c. and f. And context 92 contains processes C, a, c, d, and x. 
15 One particular process in each context, called the "context process", is known both within the context and 
within the Immediateiy enclosing one (referred to at its "parent context"), in the example illustrated in FIG. 4, 
processes A-C are context processes for contexts 90-92, respectively. The parent context of context 91 is 
context 90, and the parent context of context 92 is context 91 . Conceptually, the context process is located on 
the boundary of the context and acts as a gate into it 
20 Processes inside context 92 can reference any processes Inside contexts 90 and 91 by name. However, 
processes in context 91 can only access processes in context 92 by going through the context process C. 
Processes In context 90 can only access processes in context 92 by going through context processes B and 
C. ~ 

The function of the context process is to filter incoming messages and either reject them or reroute them to 
25 other processes in its context. Conte.xts may be nested, allowing a hierarchy of abstractions to be 
constructed. . A context must reside completely on one node. The entire system is treated as an 
all-encompassing context which is always present and which is the highest level In the hierarchy. In essence, 
contexts define localized protection domains and greatly reduce the changes of unintentional naming 
conflicts. 

30 If appropriate, a process inside one context can be "connected" to one inside another context by 
exchanging PID's, once contact has been established through one or the other of the context processes. 
Most process servers within the present invention function that way. Initial access is by name. Once the 
desired function (such as a window or file) is "opened", the user process and the service communicate directly 
via PID's. 

35 A "message" is a variable-length buffer (limited only by the processor's physical memory size) which carries 
information between processes. A header, inaccessible to the programmer, contains the destination name 
and the sender*s PID. By convention, the first field in a message is a null-terminated string which defines the 
type of message (e.g., "read", "status", etc.) Messages are queued to the receiving process when they are 
sent- Queuing ensures serial access and is used in preference to semaphores, monitors, etc. 

40 Messages provide the mechanism by which hardware transparency is achieved. A process located 
anywhere in the virtual machine can send a message to any other process if it knows its name. Transparency 
applies with some restrictions across bridgeways (i.e., the interfaces between LAN's operating under identical 
network protocols) and, in general, not all across gateways (i.e., the interfaces between LAN's operating under 
different network protocols) due to performance degradation. However, they could so operate, depending 

45 upon the required level of performance. 

With reference now to FIG, 5, the relationship of externa! events to processes will now be described. The 
virtual machine makes devices look like processes. For example, when an interrupt occurs in an external 
device 1 01 , the virtual machine kernel 61 queues an interrupt message 1 03 to a specific process 1 04, known as 
an "external event service process" (EESP), functioning as the device manager. For efficiency, the message is 

50 pre-allocated once and circulates between the EESP and the kernel. The message contains just enough 
information to indicate the occurrence of the event. The EESP performs all hardware-specific functions related 
to the event, such as setting control registers, moving data 105 to a user process 106, transmitting "Read" 
messages from the user process 106, etc., and then "releasing" the Interrupt. 
To become an EESP, a process issues a "connect" primitive specifying the appropriate device register(s). It 

55 must execute a "disconnect" before it exits. Device-independence Is achieved by making the message 
protocol between EESP's and applications processes the same wherever possible. 

Inter-Process Communication 
All inter-process communication Is via messages. Consequently, most of the virtual machine primitives are 
60 concerned with processing messages. The virtual machine kernel primitives are the following: 
ALLOC - requests allocation of a (message) buffer of a given size. 

requests deallocation of a given message buffer. 
PUT-er\6 a message to a given destination (by name of PID). 

GET- wait for and dequeue the next incoming message, optionally from a specific process (by PID). 
65 FORWARD 'p^ss a received message" through to another process. 
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CALL ' send a message, then wait for and dequeue the reply. 
REPLY- send a nnessage to the originator of a given message. 

ANY^MSG - returns "true" if the receive queue is not empty, else returns "false"; optionally, checks rf any 
messages from a specific PID are queued. 

To further describe the function of the kernel primitives, /\Z.Z.OC handles all memory allocations. It returns a 5 
pointer to a buffer which can be used for local storage within the process or which can be sent to another 
process (via PUT, etc.). ALLOC never "fails", but rather waits until enough memory is freed to satisfy the 
request. 

The Piyrprimitive queues a message to another process. The sending process resumes execution as soon 
as the message is queued. 70 

FORWARD is used to quickly reroute a message but maintain information about the original sender 
(whereas Pty7 always makes the sending process the originator of the message). 

REPLY sends a message to the originator of a previously received message, rather than by name or PID. 

CALL essentially implements remote subroutine invocations, causing the caller to suspend unt^^ the receiver 
executes a REPLY. Subsequently, the replied message is dequeued out of sequence, immediately upon is 
arrival, and the caller resumes execution. 

The emphasis is on concurrency, so that as many processes as possible are executed in parallel. Hence 
neither PUT not FORWARD vjbSXs for the message to be delivered. Conversely. GETsuspends a process until 

a message arrives and dequeues it in one operation. The ANY MSG primitive is provided so that a process 

may determine whether there is anything of interest in the queue before committing itself to a GET. 20 

When a message is sent by name, the destination process must be found In the name space. The search 
path Is determined by the nesting of the contexts in which the sending process resides. From a given process, 
a message can be sent to all processes in its own context or (optionally) to those in any higher context. Refer 
to FIG. 6. The contexts are searched from the current one upward until a match is found or until the system 
context is reached. All processes with the same name in that context are then queued a copy of the message. 25 

For example, with reference to FIG. 6. assume that in context 141 process y sends a message to ALL 
processes by the name x. Process y first searches within its own context 141 but finds no process x, The 
process y searches within the next higher context 131 (its parent context) but again finds no process x. Then 
process y searches within the next higher context 110 and finds a process x, identified by reference numeral 
112. Since it is the only process x in context 110, it is the only recipient of the message from process y. 30 

If process a in context 131 sends a message to ALL processes by the name x, it first searches within its own 
context 131 and. finding no processes x there, it then searches within context 1 10 and finds process x. 

Assume that process b in context 131 sends a message to ALL processes by the name A. it would find 
process A (111) in context 110, as well as process A (122) which is the context process for context 121. 

A process may also send a message to Itself or to its context process without knowing either name 35 
explicitly. 

The concept of a "logical ring" (analogous to a LAN) allows a message to be sent to the NEXTprocess in the 
system with a given name. The message goes to exactly one process in the sender's context, if such a process 
exists. Otherwise the parent context is searched. 

The virtual machine guarantees that each NEXT transmission will reach a different process and that 40 
eventually a transmission will be sent to the logically "first" process (the one that sent the original message) in 
the ring, completing the loop. In other words, all processes with the same name at the same level can 
communicate with each other without knowing how many there are or where they are located. The logical ring 
is essential for distributing services such as a data base. The ordering of processes In the ring is not 
predictable. 45 

For example, if process a (125) in context 121 sends a message to process a using the A/EAT primitive, the 
search finds a first process a (124) in the same context 121. Process a (124) is marked as having received the 
message, and then process a (124) sends -the message on to the /VEAT process a (.123) in context 121. 
Process a (123) is marked as having received the message, and then it sends the message oh to the NEXT 
process a, which is the original sender process a (125), which knows not to send it further on, since it's been 50 
marked as having already received the message. 

Sending messages directly by PID obviates the need for a name search and ignores context boundaries. 
This is known as the DIRECT mode of transnritssion and is the most efficient. For example, process A (111) 
sends a message in the DIRECT mode to process ^ In context 141. 

If a process sends a message in the LOCAL transmission mode, it sends it only to a process having one 55 
given name in the sender's own context. 

In summary, including the D/ffECftransmission mode, there are five transmission modes which can be used 
with the PUT, FORWARD, and CALL primitives: 

ALL - to all processes with the given name in the first context which contains that name, starting with the 
sender's context and searching upwards through all parent contexts. 60 
LOCAL - to all processes with the given name in the sender's context only. 

NEXT -to the next process with the given name in the same context as the sender, if any; otherwise It 
searches upwards through ail parent contexts until the name is found. 

LEVEL -sends to "self (the sending process) or to "context" (the context process corresponding to the 
sender's context); "self" cannot be used with CALL primitive. 55 
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DIRECT' sent by PID. 

Messages are usually transmitted by queueing a pointer to the buffer containing the message. A message is 
only copied when there are multiple destinations or when the destination is on another node. 

5 Operating System 

The operating system of the present invention consists of a kernel, which implements the primitives 
described above, plus a set of processes which provide process creation and termination, time management 
(set time, set alarm, etc.) and which perform node start-up and configuration. Drivers for devices are also 
implemented as processes (EESP's), as described above. This ailows both system services and device drivers 
10 to be added or replaced easily. The operating system also supports swapping and paging, although both are 
invisible to applications software. 

Unlike known distributed computer systems, that of the present invention does not use a distinct "name 
server" process to resolve names. Name searching is confined to the kernel, which has the advantage of being 
much faster. 

15 A minima! bootstrap program resides permanently (in ROM) on every node, e.g. ROM 28 in node N of FIG. 2. 
The bootstrap program executes automatically when a node is powered up and begins by performing basic 
on-board diagnostics. It then attempts to find and start an initial system code module. The module is sought on 
the first disk drive on the node, if any. If there isn't a disk, and the node is on the LAN, a message will be sent 
out requesting the rnoduie. Failing that, the required software must be resident in ROM. The initialization 

20 program of the kernel sets up ail the kernel's internal tables and then calls a predefined entry point of the 
process. 

Thus there is no well-defined meaning for "system up" or "system down" - as long as any node is active, the 
system as a whole may be considered to be "up". Nodes can be shut down or started up dynamically without 
affecting other nodes on the network. The same principle applies, in a limited sense, to peripherals. Devices 
25 which can identify themselves with regard to type, model number, etc. can be added or removed without 
operator intervention. 

Standard Message Format 

FIG. 6 shows the standard format of a message in a distributed data processing system of the type 
30 incorporating the present invention. The message format comprises a message i.d. portion 150: one or more 
"triples" 151, 153. and 155; and an end-of-message portion 160. Each "triple" comprises a group of three 
fields, such as fields 156-158. 

The first field 156 of "triple" 151. designated the PORT field, specifies that the data field represents the name 
of the process to be created. The second field 157 of "triple" 151 gives the size of the data field. The third field 
35 158 is the data field. 

The first field 159 of "triple" 153, designated the PNTF field, specifies that the data field represents the name 
of the process to notify when the process specified in the PORT field has been created. 

A message can have any number of "triples", and there can be multiple "triples" in the same message 
containing PORT and PNTF fields, since several processes may have to be created for the same resource. 
40 As presently implemented, portion 150 is 16 bytes in length, field 156 is 4 bytes, field 157 is 4 bytes, field 158 
is variable in length, and EDM portion is 4 bytes. 

Resource/Connector Model 

The distributed system of the present invention may be viewed at several levels of complexity. The base level 
45 is the virtual machine, which defines and implements the device-Independent architecture, consisting of virtual 
"instructions", i.e. the kernel primitives. 

Layered immediately above this, and closely related to it. is the process/message model which defines how 
programs are configured in the system and how they communicate with each other. 

Just above this level is a more abstract model dealing with "resources" and "connectors". As mentioned 
50 earlier, resources may be thought of as "logical devices". Resources are accessed through "connectors", 
which are essentially logical "pointers". 

An application must have a connector to a resource in order to interact with it. Connectors are granted and 
controlled by Resource manager processes", i.e. processes which can be requested to create, delete, etc. 
resources. 

55 Resource manager processes respond to connector messages to "create" new resources and "delete" old 
ones, and to "open" an existing resource (i.e. ask for a connection to it) and later to "close" it (terminate, the 
connection to it). 

The response to creating a resource, or opening a connection to it, is a connect message. This message 
contains a service-independent connector data structure which uniquely identifies the resource. 
60 An application may create a new resource, or acquire access to an existing one, by making a request to the 
appropriate resource manager process. (Note that all resources remain controlled and protected by the 
resource manager process, and they are kept in its context.) As a result, a connector to the resource is 
returned to the application, allowing it to communicate directly with the resource. Note that, in general two 
. connectors are required - one for the resource manager process, and one for the resource {although in many 
65 / cases the resource manager process can be accessed by name). 
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When a connector is received in a message, it identifies a specific resource to which the receiving process 
has access. The entire connector must be copied into subsequent request messages to the resource. The 
messages themselves are usually sent in "direct* mode, passing the address of the connector. As mentioned 
above, messages to the resource's manager can be sent by name, if appropriate, or via an explicit connector 
(to the manager), if available. 

Both "create" and "open" requests to the resource manager process usually expect a process name as a 
parameter, and both return a connection message. A "create" request without a name causes the service to 
generate a unique name. An "open" request using a connector instead of a name may be employed to access 
the resource differently or to gain access to a closely related resource. The "delete" and "close" requests may 
accept either an explicit connector to the resource or the resource's name. 

There are five formats for connection messages: "create", which requests the creation of a new resource; 
"open", which establishes a connection to an existing resource; "delete", which requests that a specified 
resource be removed from the system; "close" which requests that the connection to a resource be 
terminated; and "connect", which provides a connection to a resource. The "connect" message normally 
represents a response to a "create" or "open" request and Is not generally sent unsolicited. 

Data exchange messages are another type of message used in the distributed system of the present 
invention. Data in any format is sent solely by means of the "write" message. Data Is requested by the "read" 
message (to which "write" or "failed" are the only responses. 

Process which only generate data should respond with "failed" to "write" requests. Conversely, a write-only . 
resource should return "no data" (i.e. a "write" message without a data "triple") if it receives a "read" request. 

There are two formats for data exchange messages: "write", which is used to send data; and "read", which 
is used to request data. A "write" message includes the source of the data, the destination resource, the 
originator of the data, the type of data (if known), and it contains a block of data. A "read" message includes 
the destination resource, an optional prompt string (which must be written exactly before any data is read), 
and a protect parameter which indicates that the input should be protected if possible. 

Appropriate status messages are used to convey the completion status of a request, or the current state of 
a service or resource. In the latter case, the status message may be requested explicitly or may be sent as the 
result of an synchronous event within the resource Itself. 

There are four formats for status messages: "query", which asks for the current status of a resource; 
"done", which indicates that a previous request has successfully completed; "failed", which indicates that a 
previous request has not completed; and "status", which gives the status of a resource, either in response to 
"query" or as the result of an asynchronous condition. 

DETAILED DESCRIPTION OF THE INVENTION 

Resource Template Messages and Resource Definition Messages 

In the distribution system of the present invention there are one or more nodes. Each node comprises a set 
of Resource Server Modules. A Resource Server Module is a process that controls one or more particular 
resources of the same class. For example a Resource Server Module may take the form of a data manager, 
human interface manager, network interface module (NIM), port manager, message server, debugger, console 
manager, event manager, command line interpreter, etc. Each Resource Server Module is run-time 
configurable in accordance with information contained within a Resource Definition Message. 

A Resource Service Module consists of at least one resource manager process described above in the 
section entitled "Resource/Connector Model", and it is also the granule of self-configuration of the node 
which is controlled by Resource Definition Messages. It is also fully responsible for autonomously configuring 
and controlling further possible processes within or outside of the context of the main resource manager 
process if it is necessary for serving the particular class of resources. 

The Resource Server Modules are themselves created by a Configuration Management Process resident on 
each node. It is the responsibility of the Configuration Management Process to select and create the Resource 
Server Modules for its node, and to compose and send the appropriate Resource Definition Messages to the 
Resource Server Module in accordance with the given configuration requirements. 

A Resource Definition Message is what provides all of the attributes of the resource to be served as well as 
ail relevant attributes of the running environment. The Resource Definition Message tells how to configure the 
resource and tells the Resource Server Module what to do. Each Resource Definition Messages is derived 
from a Resource Template Message. 

A Resource Template Message is what defines the attributes of a resource for all node environments that 
are reasonable to expect. Resource Template Message contain the necessary rules and information for 
enabling each nodal subsystem to configure itself. A Resource Template Message is a generic form of 
Resource Definition Message. There are generally a plurality of Resource Template Messages for the entire 
system. 

Configuration Control Attributes 

Each Resource Template Message, Resource Definition Message, and Node Definition Message comprises 
a set of attributes. An attribute includes an attribute name and an attribute value. 

Resource Template Messages contain a set of special attributes called the Configuration Control Attributes. 
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These attributes control the implementation of Resource Definition Messages from a Resource Template 
Message by the Configuration Management Process. 

The Configuration Control Attributes and their meanings are given as follows: 
FEATURE' the whole resource is conditional on a Node Definition Message attribute 
5 SUBSTITUTE - a Node Definition Message attribute vaiue Is to be used as a Resource Definition Message 
attribute 

CONDITIONAL - a Resource Definition Message attribute has values conditional on Node Definition Message 
attributes 

FILE - the content of a specific file is to be used as Resource Definition Message attribute value 
10 ADDRESS/NO ADDRESS - the whole resource is conditional on the existence or absence of a given bus 
address 

PROCESS/NO PROCESS - the whole resource is conditional on the existence or absence of a process with a 
given name 

CREATE RSM- create a Resource Server Module 

15 NOTIFY RSM ' send this Resource Definition Message to a Resource. Server Module 

GLOBAL - the Resource Server Module has to be transparently accessible in the network; if set, the 
synchronization and connection to this resource can be requested anywhere in the network where needed 
GROUP -the Resource Definition Message is the header of a group of resources 
CONNECTION -a Resource Template Message attribute to pool resources into a group 

20 OPTION -XeWs what to do if the resource service cannot be started 
UP EVENT- an attribute for reporting resource service availability 
SVA/C/-/- another resource type which the resource service depends upon 

The FEATURE, SUBSTITUTE, CONDITIONAL, FILE, ADDRESS, NO ADDRESS, PROCESS, and NO 
PROCESS and attributes are the most important, and they are used by the Configuration Management 

25 Process to convert the Resource Template Messages into Resource Definition Messages. 

Node Template Messages and Node Definition Messages 

A Node Definition Message describes the concrete node environment. Generally, there is one Node 
Definition Message for each node. Node Definition Messages are structured identically to Resource Definition 
30 Messages and Resource Template Messages. 

A Configuration Management Process composes and sends the appropriate Resource Definition Messages 
to the Resource Server Modules in accordance with the informational content of a Node Definition Message 
and all Resource Template Messages. That is, the Configuration Management Process on each node reads the 
Node Definition Message for that node, as well as all possible Resource Template Messages, and it generates 
35 the Resource Definition Messages for that node. 

FIG. 7 shows how Resource Template Messages. Node Definition Messages, and Configuration 
Management Processes are used in the present invention, FIG. 7 shows a distributed system comprising 
nodes 170-174. Other nodes may also be coupled to this network, as represented by dotted connection 175. 
Each node requires one or more resources to support it. During the configuration of, for example, node 171, a 
40 Configuration Management Process (CMP) resident at node 171 utilizes one or more Resource Template 
Messages (RTM) and a Node Definition Message (NDM) and generates Resource Definition Messages to the 
Resource Server Modules (RSM) also resident at node 171. 

In general, a Resource Definition Message looks almost like a Resource Template Message, except that 
values in certain fields are different This is because the values in certain fields are conditional upon node 
45 attributes in the Node Definition Message or upon the content of specified files in the file system. 

Node Definition Messages can be derived from Node Template Messages, Just as Resource Definition 
Message are derived from Resource Template Messages. A Node Template Message is the generalization of 
all possible Node Definition Messages in the system. In this way several heirarchical layers of 
self-configuration of the operating system can be built. In the bottom layer there are elementary resources, 
50 whereas in the higher layers more complex resource clusters can be configured. 

As explained above and in the accompanying flowcharts shown in FIGS. 9A-9D and described hereinafter. 
Resource Definition Messages are derived by making checks and substitutions from Resource Template 
Messages and a Node Definition Message. Using appropriate knowledge engineering techniques, an expert 
system could be utilized to derive Resource Definition Messages from more complex forms of Resource 
55 Templates and by also making inferences at run-time in additional checks and substitutions. 

If the Resource Template Messages and Node Definition Messages themselves can be generated by an 
expert system, this makes available a new dimension of configuration expert system heirarchies, with the 
configuration of run-time resources at the bottom level and configuration of product design at the higher 
levels. 

60 FIG. 8 shows in flow diagram form how Resource Definition Messages are generated to a Resource Server 
Module. A Configuration Management Process 230 utilizes a Node Definition Message (which may be derived 
from a Node Template Message) and a quantity N of Resource Template Messages to generate a quantity M of 
Resource Definition Messages (M always being less than N). Then a Resource Sen/er Modules 231-234 use 
the Resource Definition Messages to configure the various nodal resources. Examples of these modules are 

65 an Event Manager 231, a Console Manager 232, a Port Manager 233. and a Debug Manager 234. ' 
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oZIZIL^., syste. composes the kerne., the Process Manager Process, an. 

and fperrms the process notifications and process creations using the servces of the kernel and the 
ProrP« Manaaer Process, as specified by the Resource Template Messages. 

?SrResoC?ce De °nition Messages for initial node start-up are stored in conf.gurat.on f, les^ In order to 
acIeL these configuration files, further operating system services must be included in the start-up module, 
fnclud ng fiL management services, the network interface module (NIM). and clock "^-"^semen Jhese w 
built^ServLes are also started up by interpreting resource definitions by the Configuration Management 
P^oc^ss There is no difference between the representation and the interpretation of the resource def.n.tons 
Tn The configuralfon files and for the built-in services other than that the latter ones are bu.lt into the start-up 

"^The'confiquration and process management services that are requested at node start-up time can be 75 
invoked ?ate? at any time by sending sta^ard request messages to these service processes. Therefore the 

at each node reads the Node Definition 
Messaae tor that node as well as all possible Resource Template Messages, and .t generates the Resource 
nSion Messages fo that node. Each Resource Server Module at the node utilizes the Resource Definition 
^eTsaqes^o conlf^^^^^^^ resources which it controls. Therefore, each Resource Server Module is run-time 
confSable in accordance with the information contained within the Resource Defln.tion Messages^ 

?i;s ad^ng a new node or changing the features of a node does not require changes ,n the configuration 
rules (Resource Template Messages) or in the node descriptions of the rest of the network 

Chanqes can "irS both before start-up and at run-time, since both the configuration and the 
coSgu?a7on rule descriptions are represented in data structures (Resource Template Messages and Node 

Definition Messages) which are accessible at run-time. inf„rmotinn <;ince it is nossible to define 

New nodes can also be added without any change in configuration information since it is possiDie xo aerine 
deS concJtSs n the Resource Template Messages and/or the Node Definition Messages 

Fulerboth the Resource Template Messages and the Node Definition Messages can be easHy read and 
orrcessed without any pre-processing, other than checking for conditional attnbutes Tha is, both the 
STsou'^TrpSl Me^Lg^ and No3e Definition Messages are P^-^^J.^^^^Irnefded"'"' 
structures and no run-time syntax conversion of the configuration information is needed. 

The configuration information represented by the Resource Template Messages and Node Deflni ion 
Messages ?an be both fault tolerant and transparent to requesting processes. The R--^-^^^^^ 
Message files and Node Definition Message files can be stored on more than multiple nodes to provide fault 



' T^rsynchronization of configuration events can also be easily managed using the present invention since 

[n JaS before Se file management sen/ice, which in turn should be initiated before the event management 
^Thforooer sequencing can be specified by attribute information in the Resource Template Messages. 

Km^aKessages. rather than by having to alter the operating system code. This is a very important 

advantage in a distributed operating system. 

''^^"^L^^^^^^^ "C- language implementation of the concepts relating to the 

seSjuraSn? of nodes as described hereinabove. These concepts are also represented in flowchart 

mo^uleTs conTined Sin Program Listing A attached hereto^ In decision block 180 J^^ r^utme determines 
whether the resource to process is in this start-up phase. If YES, the routine proceeds to block 181 , where the 
resource attributes are checked in this node environment. In decision block ^ 82 if the definition from the 
emplLte can be created the routine passes to decision block 183; if not it passes to decision block 188^ 
'Tn'?ecision block 183, if a new resource group is to be opened 

new resource group is inserted in the list of resource groups, and then to block ^o^^f^^n t^^^^^ 
Resource is parTof other groups. In decision block 183. if a new resource group is not to be opened, the routine 

passes to decision block 166. 
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in decision block 1 86, if the resource is part of other groups the routine passes to decision block 188. If not, 
it passes to block 187 where the resource is instantiated (i.e. processes of Resource Server Modules are 
created, and Resource Definition Messages are created and sent to processes). In decision block 188 if there 
are no more resources in the list of templates, the routine proceeds to block 189 where the resource groups 
5 are instantiated. If there are more resources In the list of templates, the routine returns to decision block 180 
for further processing. 

FIG. 9B shows a flowchart illustrating the Instantiate Resource module of the present invention, wNle 
module is also contained within Program Listing A attached hereto. In decision block 190, if the resource is to 
be synchronized the routine passes to block 191 , where the resource is enqueued for synchronization. If not, it 
10 passes to decision block 192. 

if the resource is enqueued for synchronization, after the specified synchronization event has been reported 
to configuration management, the routine is re-entered to proceed with processing this resource template. 

In decision block 192, if the resource template specifies any attribute the value of which has to be replaced 
by a given file content, the routine proceeds to block 193; else it proceeds to block 194. In block 193 the 
/5 specified file is attempted to be opened in order to start substituting the attribute value by the file content, and 
the routine exits. It wilt be re-entered to start processing the resource template again after the file has been 
read in and the attribute has been modified. 

In decision block 194, if the process to be created exists, the routine proceeds to decision block 197. It not, 
it proceeds to block 195, where an attempt is made to create it. In decision block 196, if the attempt at creating 
20 the process was successful, the routine proceeds to decision block 197. If not, it proceeds to block 203, where 
the resource creation is identified as failed. 

In decision block 197, if there are more processes to create, the routine returns to decision block 194, but if 
not the proceeds to decision block 198. In decision block 198. if the process to be notified exists, the routine 
passes to block 199, but if not it proceeds to biock 203. In block 199 the resource definition message is derived 
25 from the resource template message, and the routine then passes to block 200, where the resource definition 
message is sent to the process. 

Then the routine passes to decision block 201, where, if there are more processes to notify, it returns to 
decision block 198, but if not it proceeds to block 202, where the resource is checked to see if it is to be used 
to access more templates. 

30 FIG. 9C shows a flowchart illustrating a module to Derive Resource Definition Message from Resource 
Template, which module is also contained within Program Listing A attached hereto. In decision biock 231, if 
there are attributes to be checked in the node definition or to be replaced by files, the routine passes to block 
233, where the resource template definition is duplicated. If not. the routine proceeds to biock 232, where the 
resource message is made by duplicating the template, and then the routine exits. 

35 After biock 233, the routine proceeds to block 234, where a check for attributes is made in the node 
definition. In decision block 235, if a valid attributes is found in the node definition, the routine proceeds to 
biock 236, but if not it proceeds to block 237. In biock 236 the node attribute is used, and the routine proceeds 
to decision block 238. In block 237 the attribute is removed from the resource message. In decision block 238, 
if there are more attributes to check, the routine returns to block 234. but if not it proceeds to biock 239, where 

40 it inserts all file contents that have been specified in the template as attribute values and that ail have already 
been read in the memory. 

FIG. 9D shows a flowchart illustrating a module to Check Resource Attributes in this Node Environment, 
which module is contained within Program Listing B attached hereto. In decision block 210/ if there is a node 
feature to check, the routine proceeds to decision block 211, but if not it proceeds to decision biock 212. in 

45 decision block 211, if the node feature is present in the node definition, the routine returns to decision block 
210, but if not it proceeds to block 220, which returns a FALSE status. 

In decision block 212, if there is a bus address to check, the routine proceeds to decision block 213, but if 
not it proceeds to decision block 214. In decision block 213. if the address probe was successful, the routine 
proceeds to decision block 214, but if not it proceeds to biock 221 , which indicates a resource creation failure, 

50 and hence to biock 222, which returns a FALSE status. 

In decision biock 214, if there is a process existence to check the routine proceeds to decision block 215, 
but if not it proceeds to decision biock 216. In decision block 215,. if the process probe was successful, the 
routine passes to decision block 216, but if not it proceeds to block 221. 

In decision block 216, if there is a size compatibility to check, the routine proceeds to decision block 217. 

55 but if not it proceeds to biock 218. In decision biock 217, if the size check was successful, the routine 
proceeds to decision block 218, but if not it proceeds to biock 221. In decision block 218. if there are more 
attributes to check, the routine returns to decision biock 21 2, but if not it proceeds to block 219, which returns 
a TRUE status. 

60 Correlation of Flowcharts to Program Listings 
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It Will be apparent to those skilled in the art that the herein disclosed invention may be modified in numerous 
65 ways and may assume many embodiments other than the preferred form specifically set out and described 
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PROGRAM LISTING A 



8 

9 HoduLe : %HX %IX 

10 Dace submitted : %EX UIX 

11 Carecaicer : Gabor Simor 

12 Origin : cX ^ • - - . , -i u, 

13 Description : Creates and notifies processes about initial ly avaitabL 

14 resources- 

15 - 

16 V 

17 *fifndef lint 

IS static char SrcIdC] = "XZX^XzXlZ"; 

19 #endif 

20 

21 #include <cX.h> 

22 ^include <os/vers.h> 

23 ^include "config-h" . 



24 ^include <ern7i.h> 

25 # include <gen_codes.h> 

28 Initial Processing of Resource Messages at startup time , 

30 

31 void cni_ini_not<hrdcoded) 

32 boot hrdcoded; 

33 C 

34 extern void notifyC); 

35 extern boot checic_in3roupsC); 

36 extern boo I chec)c_rsrcC); 

37 extern void new_group(); 

38 extern char *res_lst; 

39 extern void rls groupsC); 
40 

41 RES_HO *nxt_in_queue, *prv; 

42 MSG_HANDL£ handle; 

43 boo I hrdc; 
44 

45 nxt_in_queue = prv ' CRES_HD *) res_lst; 

46 white Cnxt_in_queue) C 

47 Ini handlaC&handle,nxt_in queue, FALSE) ; 
48 

49 #if lONCtINI_TRACE) ^, 

50 printf ("resrc started Xs\n",Get_tnpLeC&handle,CLSS,_)}; 

51 #endif 
52 

53 if (Get triple(&handle,HRDC,_)} 

54 ■ hrdc = TRUE; 

55 else 

56 hrdc = FALSE; 

58 i f ( ChrdcodedS&hrdc) | ] C C ! hrdcoded )&&( i hrdc) ) ) < 

59 . if (check rsrc(Shandle}) < 

60 if (Get~triple(&handle,GRPC,_)) C 

61 new_group(&handle); 

62 check_in groupsC&handle) ; 

63 > " 

64 else 

65 if (icheck in groupsC&handle) ) 

66 ~ ~ notify(&handle); 
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67 prv = nxt_in_queue; 

68 nxt in queue = nxt in queue ->nxt res; 

69 > " ■ ■ " 
70 

71 else if (nxtjn_queue 1= (R£S_HD *) res_tst> C 

72 pp/->nxt_res = nxt_in_queue->nxt_res; 

73 Free<nxt_in_queue)7 

74 nxt_in_queue = prv->nxt res; 

75 > " 
76 

T7 else 

73 nxt in_quetje » CCK£3_BD *) res_lst)->nxt_res; 

79 > " 

80 

81 else C 

82 prv = nxt_in_queue; 

83 nxt_in_queue = nxt_in_queue->nxt_res; 

84 } 

85 > 
86 

87 rls_groups(); 

88 } 
89 

91 Instantiate Resource: 

92 - Create all specified service processes, if do not exist 

93 - Notify all specified processes, -ff they do exist 

95 

96 void notifyCh) 

97 MSG HANDLE *h; 

98 C " 

99 extern char *mefflcpyC); 

100 extern long MewProcC); 

101 extern void bad_rsrc(); 

102 extern char *Nxt attrC); /* find next given attribute V 

103 extern char *instmsg<); /*. instant! ate a resource message* 

104 extern void to_syncnot(); /* synch notify with "Isync" msg*/ 

105 extern char *f i le in msgC); /* look for file triples •/ 

106 extern void cm opencT; /* open a triple file */ 
107 

108 extern boot^sync MIH_state; 

109 extern boot^sync FILE state; 

110 " ^ 

111 MSG_HAHDLE h1, hrep; 

112 char *repnisg; /* Process_mgt reply */ 

113 COHHECTOR ntfconn; /* proc to be notified on resrc */ 

114 char *pcrt; /* process to creete */ 

115 char *pntf; /* process to notify V 

116 char •boot class; /* class of hardcoded boot device* 

117 char *upstr; /* upstr to sync with */ 
lis char *tnpl; /* proc teinpl name in configfile*/ 

119 char *file; /* fite to read for triple cont */ 

120 keyword *opkwd; 

121 char msg idCHSGID SIZEl, *msid; /* messageid to be sent */ 
122 

123 #if lONClINI.TRACE) 

124 pnntf("Xs in notify \n",Get tripleCh,CLSS,_) ); 

125 #€ndif 

126 ■ . 

127 if (upstr = (char *) Ge:_tripleCh,SYNC,_)) C 

128 to_syncnot<h, upstr );~ 

129 return; 

130 } 
131 

132 if (file = file in msgCh, , FALSE)) C 
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133 cxii_op€nCte,fi le); 

134 return.; 

135 > 
136 

137 Inf_handleCSh1 ,h'>msg_start, ,TRUE); 

138 while (pert = Nxt_attr(&h1 ,PCRT) ) C 

139 if Cstrcmp("sratus",CrepfTisg = CaL UNEXT, "Process_mgt", 

Makemsg<4*2*KEYSlZ£+strten<pcrt)+10, "query", "name=#5; loci", 

1^2 tmpL = Hxt_attr(&h1,TMPL>; 

1^ if <(iNewProcess(pcrt, t7nDV,F?itS€, 

''(rGet_tripl€Cih1,0PTM,_))) C 

145 

146 #if 10NCLI«1_TRACE) 

princf("Xs can not be crea t ed\n", pert ) ; 

143 #endff 
149" 

1 5 0 bad_ rs rc C h , PR OC_CR EATE_F A I L) ; 

^51 ,f reeCrepmsg); 

152 return; 

153 > 

154 . > 
155 

156 Free(repmsg); 

157 > ' ■ 
158 

159 #if LQWdlHl TRACE) 



printf("%s port's processed \n",Get_triple{h,CLSS,_)); 



160 

161 #endff 
162 

163 Ini_handle(&h1^h->[nsg_st2rt,_,TRUE); 

164 white (pntf = Nxt_attr<&h1 ,PWTF) ) C 

''^S if C!strcmp(»status",(repmsg = CaUCWEXT,»Process_mgt", 

MakeiTisgC4*2*KEYSIZE+strLen<pntf)+10, "query", 

"naf7>e=#s; Loot", pntf ) C 
168 Ini_handle(&hrep,reansg,_,TRUE); 

ntfconn = *((COMN£CTOR •) Get tripLeCShrep,CONH,_)); 
1'"° if (opkwd - (keyword *: Get_tripleCh,OPID,_) ) 

]2 ALt_tripleCh,*-apkwd,si2eaf(ntfconn.pid) ,&ntfconn.pid); 

if Cmsid = (char Get_triple(h,HSID,_))' 
1^ strcpy(msg_fd,msid); 
174 else 

1^ strcpyCmsg id,^'resource"); 

17'6 PutCDIRECT,&ntfconn, 

1^ memcpyC instmsgCh},msg id,strlen<msg_id)+1 )}; 

C(RES_HD *} h->msg_start}->ntfpid = ntfconn,pid; 

130 else if C iGet_tripte<Sh1 ,OPTM,_)) C 
181 

182 #if LOH(UHr_TRACE) 

1S3 printf("Xs no process to notifyVn",pncf ); 

184 #endff 

185 

1S6 bad rsrc(h,MO PROC TO NOT); 

187 > 

186 Free(repmsg); 

189 > 

190 

191 if CGet_tripleC&h1,S00T,_)) C 

192 booc_class = Get_triple<&h1 ,CLSS,_); 

194 ff CIstrcmpCboor class , "LAW") ) 

195 . NIH_stace = polled; 
else if~(I strcmo(boot_class,"disk_ctrL")) 

FIL£_scate - pollec; " 



196 
197 

198 else 
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199 bad rsrc<h,8AD 8OOT_0EV__0EF); 

200 > " " 

201 > 
202 

203 r 

204 Synchronization notification to continue processing of a pending 

205 resource 

206 •/ 
207 

208 void from_syncnot(sync_hd,resmsg} 

209 MSG^HAMDLE *sync_hd; 

210 char *resmsg; 

211 C 

212 extern char *Nxt_attr<); 

213 extern void to_syncnot(); 

214 extern void Alt_keyC); 

215 extern void notTfyO; 
216 

217 MSG^HANDLE res_hd; 

218 char *upst_in,~*upst; 

219 boot no_more sync; 
220 

221 upst_in = Get_triple<sync hd,UPST,_); 

222 Ini_handle(&res_hd,resmsg7_,W0FIX|SUSP); 

223 no nx3re_sync = TRUE; 

224 while (upst = >ixt_attr(&res_hd,SYNC) ) C 

225 if CistranD<Lrpst,upst_in>) 

226 " Alt key ( upst, UP); 

227 else <: 

228 to_syncnot(&res_hd,L;pst); 

229 no_more_sync = FALSE; 

230 break; 

231 > 

232 > 
233 

234. if ( no_mo re_sync) 

235 notify(&res_hd); 

236 FreeCsync hd->msg start); 

237 > 
238 

239 /* 

240 Ask for synchronization notification that triggers continuation 

241 of processing a resource 

242 V 
243 

244 void to_syncnotCh,upst) 

245 HSG_HAWDLE *h; 

246 char *upst; 

247 C 

243 PutCSELF, ,MakemsgC2*K£YSr2E+sizeof (h->msg St3rt)^trlen(upst)+1 , 

249 " »'?syrK:h", "upst=#s; sync^il", upst, h->msg_start)) 

250 > - 
251 

252 

253 void Alt key(v,k) 

254 char *v;~ 

255 keyword k; 

256 C 

257 V -= 2 * sizeof(k); 
255 *( (keyword *) v) = k; 
259 . > 

260 

261 /» 

262 Open new resource group 

263 */ 
264 
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265 void new group<h) 

266 HSG_HANDL£ *h; 

267 < 

268 extern char *grD_lst; /* list of resource groups */ 
269 

270 RES_HD *nxt_in queue; 

271 

272 #lf lONdlNI TRACE) 

273 pn'ntf("Xs in new groupXn", Ger_trf pleCh^lSS^_>>; 

274 #endif 
275 

276 nxt_in_queue = (RE5_HD *) grpjst; 

277 white <nxt_in_queue- >nxt_g rp) 

278 nxt in queue ' nxt in queue- >nxt grp; 

279 ~ ~ ~ " 

280 nxt fn_queue->nxt grp = (RES HD *) h->msg_start; 

281 > 
282 

283 /* 

284 Check if a resource is a cofnponent of any group 

285 If a resource belongs to more than one group, all group resources bad 

286 */ 
287 

288 boo I checIc_in_groupsCh) 

289 MSG HANDLE *h; 

290 C " 

291 extern bcol checic_fn__grpC 3 ; /* check if in one group */ 

292 extern void rmv rsrcC); /* reinove resource ♦/ 
293 

294 extern char *grp 1st; /* resource group list start V 

295 

296 RES HD *nxt in_queue; /* next res group in list */ 

297 MSG^HANDLE hi; /* current group checked */ 

298 MSG_HANDLE hgrp; /* located group head resrc */ 

299 boo I in_a_group; 

300 boot grp_nnvd; /* grouo head resrc ren)oved */ 
301 

302 #lf lONClINr^TRACED 

303 pr intf(":'»s in check in groups\n",Get_tripte(h, CLSS,_) ) ; 

304 #end if * " 
305 

306 grp_rmvd = FALSE; 

307 in a_group = FALSE; 

308 " 

309 nxt_in_queue = (CRES_HD *) grp_tst)->nxt_grp; 

310 while (nxt_in_queue) C 

311 if (nxt in queue != (RES HO *) h->fnsg_start) < 

312 ~ ~ ~ 

313 Inf handle(&h1^(char *) nxt_in_queue, ,TRUE); 
3U 

315 if (check_in_grp(&h1,h)) 

316 if C ! in_a_graup) < 

317 Tn3a_gr"0up = TRUE; 

318 hgrp = h1; 
319 

320 #if laN(tI«I_TRACE) 

321 printf("%s grp head found: Xs\n",Get_tripteCh,CLSS,_) , 

322 Get triple(&h1,CLSS,__)); 

323 #endif " 
324 

325 > 

326 else < 

327 bad_rsrc(&h1,D0UBL£_GROU?); 

328 , rmv~rsrcC&h1 ^ ; 

329 if ^igrp rmvd) C 

350 bad~rsrc(&hgrp,DOUSL£_GRCUP); 
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331 nnv rsrcC&hgrp); 

332 > " . 

333 grp rtnvd = TRUE; 

334 > 

335 } 

336 nxt_in_queue = nxt_in queue ->nxt_g rp; 

337 . > " . 
338 

339 if (in a_group&&! grp_rnTvd) 

340 ~ returnCTRUE); 

341 else 

342 returnC FALSE); 

343 > 
344 

345 /* 

346 Check if a resource is a component of one particular group 

347 If it is, append it to the component list of the group 

348 increment msg nr count in each component 

349 . */ 
350 

351 static bool check in grp(hg,hc) 

352 MSG_HAHDLE •hg; " ~ /* group head handle */ 

353 MSG_HAWOLE *hc; /* cofnponent head handle */ 

354 <: 
355 

356 RES_HO ♦nxt_in_lst; 

357 keyword keyw; /* keywrd to mark grouD coops * 

358 unsigned long marksz; /* size of the mark attribute * 

359 char *markg; /* ptr to mark attr in grp hd ♦ 

360 char *markc; /* ptr to mark attr in comp * 

361 short *msnr; /* nisg nr following in the grp* 

362 Long zero? 

363 short short_zero; 
364 

365 keyw = *C(keyword *) Get_cripLe<hg, GRPC,_) ); 

366 

367 if <markc = Get_triple(hc,keyw,_) ) C 

368 markg - Get triple(hg,keyw,&marks2>,- 

369 ■ ~ ■ 

370 if (lstrncmp(markg,markc,( int) marksz)) C 
371 

372 #ff lOHCirHt_TRACE) . 

373 printfC'Xs match found in check_in_grp\n",Get_triple(hg,CLSS,_)); 

374 #endif 
375 

376 msnr = (short *) Get_tripleChg,MSHR,_); 

377" (*msnr)'M-; 

378 Alt_tripleChg,HSHR, si zeof( short), msnr); 

379 

380 nxt_in_tst - (RES_HD *) hg->msg_start; 

381 while Tnxt in_Lst~>nxt_coaip) 

382 nxt_Tn 1st = nxt_in_lst->nxt comp; 
383 

384 nxt in lst->nxt_comp = CRES_HD ») he- >msg_start; 

385 

386 return(TRUE); 

387 > 

388 else 

389 - re turn( FALSE); 

390 > 

391 else 

392 returnC FALSE); . 

393 > 
39C . ■ 

395 /* 

396 Release all group lists, create and notify all related processes 
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397 (each resource is assumed to have been checked on exi stance) 

398 */ 
399 

400 static void rLs_groupsC) 
A01 C 

402 extern void notifyC); 

403 extern void rls_grp(); 

404 extern char *grp_Lst; /* list of resource groups V 
405 

406 MSG^HAMDLE h; 

407 RES_KD *nxt_in_Lst; 
408 

409 nxtjn_lst = <CR£S_HD *) grp_lst)->nxt_grp; 

410 while Tnxt_in_lst)" -C 

411 Inf_handLe<&h,nxt_in_lst,_,TRUE); 
412 

413 #if 10NCIINI_TRACE) 

414 printfC'Xs in rLs_groups\n'\Get triple(Sh,CLSS,_) ) ; 

415 #endif 
416 

417 if C!C(RES HO *) h.msg start) •>ntfpid) 

418 " " rls_grpC&h); 
419" nxt_in_Lst = nxt_in_lst->nxt grp; 

420 > 

421 > 
422 

423 static void rls grp(hg) 

424 HSG_HANOLE *hg;" 

425 C 

426 extern void notifyC); 
427 

428 HSG_HAHDL£ h; 

429 RES_HD *nxt_in_lst; 
430 

431 nxt_in_lst = CR£S_HO *) hg->fnsg_start; 

432 while (nxt_in 1st) C 

433 . Ini_handleC&h,nxt_in_Lst,_,TRUE); 

434 notify(Sh); 

435 nxt_in Lst = nxt in_lst->nxt_cocTp; 

436 > " " 

437 > 
438 

439 /* 

440 Get next field with same keyword from a standard cX message 

441 (brand new handle assuned at the 1st call, 

442 no external Hxt triple expected between calls ) 

443 V 
444 

445 char *Nxt_attr(h,keyw) 

446 MSG_HANDLE *h; 

447 keyword keyw; 

448 <: 

449 char *value; 

450 keyword k? 
451 

452 while (value = Mxt_triple(h,&k:,_)) 

453 if Ck == keyw) 

454 return(value); 

455 return(NULL); 

456 > 
457 

458 /* 

459 Instantiate a message (define node-deoendant attributes) 
460 

461 

462 char *instmsg(h) 
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463 MSG HANDLE 'h; 

464 C ~ 

465 extern char •dupmsgC); 

466 extern bool attr_name(); 

467 extern unsigned long Si ze_cn'ple( ); 
46S extern char *NxT_attrC); 

469 extern void ins fileC); 

470 

471 extern RE5_HD *node res; 

472 

473 MSG_HANDLe hO, h1, h2; 

474 keyword *actr_ref , *attr_def; 

475 char *attr vaT; 

476 . 

477 if C(iGet_triple(h,SBST,_)} && ( ! Get_triple(h , FHRP,_) ) ) 

47B return(dupmsgCh*>fnsg_Etart )) ; 

479 

480 Ini_handle(ihO,dupnisgCh->msg_start), ,NOFIX|SUSP); 

481 while <attr ref = (keyword ») Nxt_attrC&hO,SBST) ) C 
LQZ If (!attr_name((char *) attr_ref)) 

433 continue; 

434 Ini haodle(&hl,h->msg start, _/FlX|SUSP); 

485 while (attr_def = (keyword *) Hxt_attr(&h1 ,*attr_ref )) C 

486 if (lattr_narT>e((char *) attr_def)) 
457 continue; 

488 else if (!node_res) C 

489 Del_triple(&hQ,*attr_ref ); 

490 continue; 

491 > 
492 

493 Ini_handle(&h2,node_res,_, FIX (SUSP); 

494 if (Kattr val = Hxt_attr(&h2,*attr_def ) )) C 

495 Del_tripLeT&hO,*attr2ref ); 

496 continue; 

497 > • 
498 

499 while CDel_tripLe(&hO,*attr ref)) 

500 

501 Add_triple(&hO,*attr_ref,Size_triple(attr_val),actr_vat); 

502 break; 

503 > 

504 } 
505 

506 ins_fi le(&hO); 

507 return(h0.msg_start); 

508 } 
509 

510 /* 

511 Duplicate a message 

512 V 
513 

514 char *dup(nsg<msg) 

515 char *msg; 

516 C 

517 extern char *[i)efix:py(); 
518 

519 char *newmsg; 

520 unsigned long size; 

521 MSGINFO fRsginfo; 
522 

523 Msg_info(msg,&msginfo); 

524 return(meaK:py(Al loc(msginfo. size), msg.msginfo. size)); 

525 J 
526 

527 /* . 

528 Return size of a triple 



23 




0 274 406 



529 V 
530 

531 static unsigned long Size tripCeCvaL) 

532 char *vaL; 

533 C 

534 val •= sizeof (keyword); 

535 returnC*(( unsigned long *) val)); 

536 > 
537 

538 /* 

539 Check if triple refers to an attribute name 

540 V 
541 

542 static booL attr_name(val ) 

543 char *vaL; 

544 i 

545 extern unsigned long Size_triple( ); 

546 extern bool aUasciiC); ~ 
547 

548 if (Size_triple(val) != sizeof (keyword) ) 

549 returnCFALSE); 

550 else 

551 return(allascif(val,si2eof( keyword))); 

552 > 
553 

554 static bool allascii(p,k) 

555 char *p; 

556 int k; 

557 < 

55B extern bool nTy_isasci !(); 

559 

560 bool all^ascii; 

561 int i; 
562 

563 aU_ascii = TRUE; . 

564 for (i=0;i<k;i++) 

565 if C!my_isasciiC*(p+i))) 

566 all_ascii = FALSE; 
567 

568 return(all_asci i); 

569 > 
570 

571 static boot my_isasci i (c) 

572 char c; 

573 C 

574 if C (c>0x1f) && (c<0x7f) ) 

575 returnCTRUE); 

576 else 

577 return(FALSE); 
573 > 

579 

580 /* 

581 Routines to replace f i le' reference triples with file content 
582 

583 fi le__in_msg(h) - look for file triples 

5S4 cm_open(h,f ile) • open triple file 

585 cni_read<ch,conn) - read a triple file 

586 mct_tripie(rh,conn) - mark a triple file as read and close it 

587 ins file(h) - insert all marked triple files in res msg 

588 cm_fmgt_err(fmh) - check if "failed" is a triple file error 

589 */ 
590 

591 static char *f i le_in_rnsg(h,keypp,af ter_read) 

592 MSG_HANDL£ *h; 

593 keyword *keypp; 

594 bool after^read; 
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595 C 

59^ extern char ♦Hxt_attr(); 

597 extern boot attr_naine( ); 

593 extern bool allasciiC); 

599 extern void Alt_key(); 

601 HSG_HAHDL£ hO, hi; 

602 keyword file; 

603 keyword •attr_ref; 

604 char *path; 
605 



if (! after read) 

file = FILE; 

else 

file = FILO; 



else 

continue; 



606 
607 
603 
609 

61? ^ <Get_triple<h,file, J) < ctyKikpv 

6 2 Ini handle(&ha,h->msg.start,_,FlX|SUSP), 

6 I while (attr ret - (keyword Hxt^attr(&hO,f i le)) 

614 if Clattr.na^<(char -"---^J>^^. 

'^''ini handle<&hl,h.>tnsg_start FIXISUSP); 
6 S while Cpath = 

AO if ((atlascii(path,strlen<path)}) W 

if (after read) 

;^(^^ key<attr_ref ,MFIL); 

623 ^ Alt_key(attr_ref,FILO); 

625 i^ Ckeypp) 

625 ,^^ypp = *attr_ref; 

return(path); 

628 
629 
630 

631 ^ 

632 > 
633 

63A return(WULL); 

635 > 

636 

637 static void an_open<h, f i le) 
63S HSG_KAMDL£ *h;" 

639 char *file; 

640 < 

641 char *opntsg; 

opmsg = H3t^emsg(MINSIZE*3*2-KEYSIZ|-strle^ 

'^name=#s; omod=#s; anrod-rfS , Tue, k , k 

645 Hsg_parmCoan3g, (char •) h- >msg_start ) ; 

646 Put(HEXT,"Fi le_mgt", opmsg); 

647 > 
648 

649 void an read<h,conn) 

650 MSG_HANDt£ *h; 

651 CONNECTOR *conn; 

652 C u r-, /^. 

653 extern void read_TUeC;, 

654 ^nnn\- /* samc as in Process^mgt 

655 read_f 1 le(h,conn), ' 

656 > 
657 

658 void mcL tripte(h,conn) 

659 MSG^HANDLE *h; 

660 CONNECTOR *conn; 
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661 

662 

663 

66^ 

665 

666 

667 

668 

669 

670 

671 

672 

673 

674 

675 

676 

677 

678 

679 

680 

681 

682 

683 

684 

685 

686 

687 

688 

689 

690 

691 

692 

693 

694 

695 

696 

697 

698 

699 

700 

701 

702 

703 



extern void close_f i leC); 
extern char *f i Le_in_fnsg< ) ; 
extern void At.t_kiy(T; 
extern void bad_rsrcC); 



/* same as in Process__mgt */ 

/* find first ^fle triple value */ 

/* change key field of a triple V 

/* change key field of a triple */ 



HSGINFO msginfo; 
MSG^HANDLE reshndl; 
char *resmsg, *path, 
keyword keyp; 



"^filel; 



Hsg_fnfo(h->msg_start/&msginfo); 
resmsg = (char *) msginfo, tag; 
Ini^handleC&reshndl , resmsg, SUSP | HOFIX) ; 

cLose_f i le(h,conn); 

path = f ile_in_msgC&resh^dl,&keyp,TRU£); 
Add_t^iple<h,KEYP,si^eof(keyp),&keyp}; 
*<(cha^-**) path) = h->msg_start; 
Alt_keyCpath,FHRP); 

if C!Get_tripleC&r€shndl,FIL0,_)5 

if C!Get_tripleC&reshndl,SADF,_)) 

not i f yC&reshndl ) ; 

else 

bad rsrcC&reshndl,FILE READ ERROR); 
> - - 

static void ins_fileCh) 

MSG_HANDL£ *h; 

C 

extern void Alt_keyC); 

MSG_KANDUE hres, hfmrep; 

char *fmrep, **fmrepp; 

char *fdata; 

char *fptr; 

unsigned long fdsize; 

keyword *keypp; 

if (Get_triple.(h,FHRP,_)) C 

Ini_handle(Shres,h->msg_start,_,FlXiSUSP); 

while (fmrepp = (char **) «xt_attr<&hres, FHRP) ) C 
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704 fmrep = •fmrepp; ctvI«ico>i. 

Ini handle<&hfmrep,fmrep,^,FIX SUSP), 

7ni fdata = Get tripLe(&hfmrep,DATA &fdsize); 

11% keypp - (keyword GeC^tnple(ihfmrep,KEYP,_) 

Add_trjple<h,»keypp,fdsize, fdata); 

7Q9 Free< fmrep); 

710 > 

l\\ mi handle(&hres,h->msg_start jFIXjSUSP); 

l]! mi handle(&hres,h->msg_start,„,FIX|SUSP); 

while (Del tripleC&hres.FMRP)) 

718 

719 > 

720 > 

722 booL cm_fmgt_err(fiTTi) 

723 HSG_HAHDLE *fmh; 

724 <; ~ 

725 extern char *f Uejn_msg(); 
726 

727 HSGIKFO msginfo; 

728 HSG^HANDLE reshndl; 

729 char *resmsg, *path, *req; 

730 keyword keyp; 

^2 req = Get triple(frrh,R£Q/_)? 

733 if CIstrciipCreq, "close")) 

returnCTRUE); 

2| Msg info<fn*i->msg_start,&fnsginfo); 

737 resmsg = (char *) msginfo. tag; 

^9 if Cini har^le<&reshrxil, resmsg ^^SP I MOFIX^^^^^ 

if Cpath = fiteJn.n.g(.resh^l^keyp,TR^^^ C 

7A1 returnCTKUE); 

742 -v 

743 

744 

745 re cur n( FALSE); 

746 > 
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PROGRAM LISTING B 



9 Module : %M% %\% 

10 Date submitted : XE% SUX 

11 Author : Gabor Simor 

12 Origin : cX 

13 Description : Configuration Management Error Handling Routins 
14 

15 . *******"^*******'*^****^*******-«********«*******-^ I 
16 

17 #ifndef lint 

18 static char SrcIdC] = "%2%%H%:%I%"; 

19 #endif. 
20 

21 ifinclude <cX.h> 

22 #include <os/vers.h> 
25 #include "config.h" 

24 #include <ernn.h> 

25 #include <gen codes, h> 
26 

27 /* 

28 Check if resource available and if its attributes are consistent 

29 with the environment 

30 V 
31 

32 bool checlc_psrc(hi 

33 MSG HAHDLE *h; . 

34 < 

35 extern void bad_rsrcC); 

36 extern bool comptbl_si2eC); 

37 extern char *Nxt_attrC); 

38 extern char *instmsgC); 
39 
40 
41 

42 char *chck; 

43 char *badr; 

44 char *si2e; 

45 char *res_feat; 

46 char *p_name; 

47 char *repmsg; 
4S char *node_feat; 

49 bool resolved; 

50 KSG_HANOLE hO, hi, hsub; 

51 - int don tea re; 
52 

53 Ini_handleC&hsub, instmsg 
54 

55 #if LOHClIHr TRACE) 

56 printf<"Xs in check rsrc\n",Get triple(h,CLSS, )); 

57 #endif ~ ~ 

5a 

59 /* 

60 check if associated node feature required 

61 V 
62 

63 Ini_handle<ShO,hsub.msg start FIX] SUSP); 

64 while (res feat = Mxt_actrCShO, FEAT) ) C 

65 if (!node_res) <: 

66 Free(hsub.msg_scart ) ; 



extern R£S_HD *node_res; 



/* 


attribute to check 


*/ 


/* 


bus address 


*/ 


/* 


buffer size of cofrms protocols 


*/ 


r 


node feature to be checked 


V 


r 


process name to be checked 


V 


/* 


reply message from Proc_mgt 


*/ 


/* 


node feature found ~ 


*/ 


/* 


if current feature resolved 


*/ 




FIX|SUSP); 
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67 peturnC FALSE); 

6a * > 

69 resolved = FALSE; 

70 lni_handte(&h1,node res,_, FIX |SUSP) ; 
j\ while <node_feat = Mxt_atrrC&hl , FEAT) ) 

72 if (!strcmp(node feat7res_feat)) C 

73 resolved = TRUE; 
7U break; 

75 . ■> 

76 if (! resolved) C 

77 Free<hsub.msg_scart); 

78 returnC FALSE); 

79 > 

80 > 
81 

82 

83 Ini handteC&hO^hsub.msg start, _,FIX|SUSP); 

84 while (chck = Nxt_attrC&hO,CHCK)) C 
85 

86 /* 

87 check on bus address existence 

88 •/ 
89 

90 if <*(Clong *) chck) = BADR) C 

91 

92 #if tONdlNI TRACE) ... 

93 " princfC'Xs to bechecked on BADR\n'\Get_tnple(h,CLSS,_) ) ; 

94 #endif 
95 

96 Ini handLe(&h1,hsub.msg start, __,FrX|SUSP); 

97 while Cbadr = Hxt_attr(&h1 ,BADR)) 

OR if (iHprobeCHP RD8,*C (unsigned long *) badr) ,&dontcare) ) C 

99 bad_rsrc(h,BADR_^NONEXT); 

Free(hsub.tnsg_s?art ) ; 

reT:urn(FALSE)7 

102 > 

103 > 
104 

105 else if (*CClong *) chck) == YADR) < 

106 

107 n\f lOHCllNl TRACE) , . ^ 

10g " printfC'Xs to be checked on BAORW,Get_rnple<h,CLSS,_)); 

109 #endif 
110 

111 Ini_handle(&h1,hsub.msg start, _,FIX|SUSP); 

112 while (badr = Nxt attrC&hl ,YAOR)) 

113 if (iHprobe(HP ROB ,*( (unsi gned long *) badr) ,&dontcare) ) C 

~ bad_rsrc(h,BADR_NONEXT); 
^15 FreeChsub.msg_start); 

returnC FALSE); 

117 ^ > 

118 > 
119 

120 else if (*CClong *) chck) == HAOR) C 

121 

122 #if lONCUKI TRACE) . , ^, 

123 printfC'Xs to be checked on aAOR\n",Get_tnpleCh,CLSS,_)); 

124 #endif 
125 

126 Ini handleC&h1,hsub.msg start, FIX |SUSP) ; 

while (badr = Nxt attrC&hl ,MADR) ) 
128 if <Mprobe(HP ROB, "C (unsigned long *) badr ), &dont care) ) C 

,yP^ r _ bad_^rs rc C h , B ADR_EX I ST ) 

^3Q Frei(hsub.msg_sTarT:) ; 

^2 ^ recurnC FALSE); 

132 • ^ 
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133 > 
134 

135 /* ; 

136 check on consistency of size attributes 

137 */ 
138 

139 else if (*C(long *) chck) == SI2H) 

1^0 if (Usize = Get_triple(h,SI2E, ))) < 

111 "bad_rs rc C h , NO_S 1 2 E_TO_C HECJC) ; 

FreeChsub.msg_start}; 

;7f returnC FALSE); 

|44 y 

else if C'coaptbl_size(h,*C(long *) size})) <: 

bad_rsrc(h, INC0MPTSL__SI2E); 

return(FALSE); 

150 > 
151 

152 /* 

* check if process exi stance conditions satisfied 
154 */ 
155 

Ini_handle(Sh1,hsub.msg_start, ,FIX(SUSP); 
'57 while (p_name = Hxt_attr(&h1 ,PROC)) 

^^^9 " CaUCNEXT,"Process_mgt",Hakefnsg 

^60 *^^YSIZE'^strten<p_narne)+1,"query"/'name#s; loci" ,p_name), 

161 bad_rsrcCh,PROC_NONEXT); 
152 FreeChsub.msg^start); 

163 FreeCrepmsg);* 

164 returnCFALSE); 

165 else ^ 

Free(repmsg); 

]^ Ini' ^andleC&h1,hsub.insg_start, ,FIXlSUSP); 

{yl (p_name = Nxt^attrCShl ,NPRC)) 

171 cl^l^^iVy^l^T^r^^.^^^ " CaUCNEXT,"Process_mgt",Makenisg 

172 ^ '^E^SI2E+strlen(p_name)+1, "query" /'namesfs; locl»,p name), 

173 bad_rsrcCh,PRac_EXlST); 

174 FreeChsufa.msg_start) ; 

175 Free(repfnsg); 

176 returnCFALSE); 

177 else ^ 
]^ FreeCrepmsg); 



150 
181 
182 



FreeChsufa.msg^start); 
returnCTRUE); 



Claims 



1. In a distributed data processing system comprising a plurality of interconnected nodes (170-174, 
FIG. 7), at least one of said nodes (170) comprising a set of resource configuration rules for configuring 
resources on any node of the system, a method of configuring resources for a specific node of said 
system (171), said method comprising the steps of: 

a) providing to said specific node a resource definition message; and 

b) utilizing said resource definition message to configure a resource sever module for each 
resource type needed by said specific node. 

2. The method of configuring resources recited in claim 1 , wherein said resource definition message is 
derived from a resource template message which defines the attributes of a resource for all anticipated 
node environments. 

3. The method of configuring resources recited in claim 2, wherein a plurality of resource template 
messages provide said set of resource configuration rules for said system. 

4. The method of configuring resources recited in claim 1, wherein said one node comprises a plurality 
of resource server modules. 

5. in a distributed data processing system comprising a plurality of interconnected nodes (170-174 
RG. 7), a method of configuring resources for one of said nodes (171). said method comprising the steps 

a) providing in said one node a configuration management process; 
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b) providing to said one node a node definition message whichi defines a configuration for said one 
node; 

c) providing to said one node a plurality of resource template messages which represent a set of 
generic configuration rules: 

d) using said configuration management process, said node definition message, and said 
resource template messages to create a resource server module for each resource type required by 
said one node; 

e) providing to said resource server module a resource definition message; and 

f) using said resource definition message to configure said resource server module. 

6. The method of configuring resources recited In claim 5. wherein said node definition message is 
derived from a node template message which defines the possible attributes of a node for all anticipated 
types of nodes in the system. 

7. The method of contigurmg resources recited in claim 5, wherein said resource definition message 
can be derived from a resource template message which det/n&s t?7e poss^bfe attributes of a resource for 
all anticipated node environmerrts. 

8. The method of configur/ng resources reched tn c/a/m 5, wherein said resource detinilioa message is 
generated by an expert system in response to at least one resource template message and at least one 
node definition message. 

9. The method of configuring resources recited in claim 5. wherein said resource template message is 
generated by an expert system. 

10. The method of configuring resources recited in claim 5. wherein said node definition message is 
generated by an expert system. 
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